Install:
--------

1: Copy the alephone folder to the Dingoo's SD card.
   (e.g. /local/ports/alephone)

2. Download one or more scenarios from
   http://source.bungie.org/index.php?title=Get_Marathon

   I really recommend playing Marathon 1 or Marathon 2 before playing Infinity
   (non-linear levels, story building on 1 and 2 and high difficulty).

3. Put the scenario data folder in alephone/data.
   (e.g. /local/ports/alephone/data/Marathon 2)

4. For Marathon 2 and Infinity, copy the files found in the "Extra's" folder
   to the Marathon 2/Marathon Infinity scenario folder, overwriting Filenames.mml
   This step is optional; it fixes the menu music.

5. Disconnect the Dingoo from your computer and start Dingux
   Add the .dge file that matches the scenario you put in 'data' directory to
   gmenu2 and play!




Upgrade:
--------
1. Rename your old alephone folder to something like "alephone-old"

2. Follow the installation instructions above, except that you do not have to re-download
   your scenario data. Just move it from the old folder to the new one.

3. Move over your 'Saved Games' folders from ".alephone/<gamename>/Saved Games".
   **Do NOT** move over the "Preferences" files or anything else.

4. That's it! Now test if everything works and if your saves are there. Then delete the old game directory.




Keys:
-----
- Main menu:
    [START]  = New game
    [SELECT] = Exit game
    (X)      = Preferences
    (Y)      = Load saved game


- In game:
    D-pad = forward, backward, turn

    (B) = primary fire/left hand weapon
    (A) = secondary fire/right hand weapon
    (X) = switch weapon
    (Y) = walk/swim if underwater

    start = change weapon
    select = exit prompt (press start to exit game)

    [L] = hold to sidestep left/right using d-pad left/right
    [R] = hold to look up/down using d-pad up/down. Double tap to center view.

    [slider hold] = display map (toggle again to exit map)


- In game, map view
    [L] = zoom in
    [R] = zoom out


- In menus:
    dpad: Move around the options
    start: Set option
    select: Exit current menu (without saving!)


Gameplay tips:
--------------
- You can only save at 'pattern buffers', which are computer screens in the game.
  Use the action key (X) to use them.
- Most armored/mech enemies are immune to the flamethrower, but extra vulnerable to fusion.
- If you get stuck, look for switches. Unreachable switches can be shot with a grenade.
  The game expects you to know this.
- Look for 'jumps'as well. While you can not jump, you can bridge long distances by air
  by running off a cliff. The game expects you to notice and do this in later levels.
- If fights get too difficult, try luring enemies to small corridors for ambush, or
  large areas so you can strafe or circle around them. They might hit each other and start
  killing off each other if you do the latter - the AI isn't bright.





Known issues:
-------------
- Some long terminal logon texts aren't centered properly.

I do not know of other issues. Let me know if you find something.


Troubleshooting
---------------

If the game does not launch you likely put the scenario data in the wrong
place, or you're launching the wrong .dge for the scenario you downloaded.
Double check you put everything in the right place.

It's not possible to type a new Saved Game name on the Dingoo. Instead, connect the
dingoo to the computer and duplicate a saved game a few times. Name them "Slot 1.sgaA" etc
and you'll have plenty of 'slots' to choose from.


3rd party total conversions:
----------------------------
The game is not setup for 3rd party scenarios, but you can easily make your
own .dge file for them using a text editor. There's one included for Tempus Irae as an example.
Do delete the hi-res graphics directories that might be included.
They are not used on the Dingoo (OpenGL only) and would eat up a *lot* of space for nothing.

Normal third party maps work out of the box, just select them in Preferences->Environment.

NOTE: If you're on windows, use Notepad++, Notepad2 or something similar to edit the .dge files.





Release notes alephone-dingoo-v3 20101128:
------------------------------------------
- Fixed liquid clipping bug in the AlephOne renderer.
- Fixed crash bug on level switch halfway through Marathon 2 and possibly others.
- 50% performance increase over v2.
- Network and LUA support excluded entirely, making the game more than 3 MB smaller.
  Slightly increases loading times.


Performance fixes include:
  Renderer hack, worsening support for super long distances (10-15%),
  Sound mixing is now done at 22050Hz instead of 44.1 (20%, much more when more channels are mixed)
  Game ignores brightness settings, avoiding gammaramp emulation code to run all the time if changed
  from default (5%).
  Compiled using -fprofile-use/fprofile-generate, good for another 15%


Release notes alephone-dingoo-v2 20101104:
------------------------------------------
- Game now renders in native 320x240. This is a new approach on a fresh source.
  It's no longer based on Pickle's source/code. Scaler is used on interface images
  before rendering.
- Big speed increase due to the above. Main marathon games run full speed most of
  the time @ 336 MHz. No overclock needed.
- Damage/pickup/liquid flashes now work thanks to software gamma emulation.
- Map zoom keys mapped to shoulder buttons when in map view.
- Terminal code reworked to render at 320x240 properly.
- Preference screens/widgets reworked to fit properly on Dingoo screen.
- Game will create its own working settings file now if it doesn't exist. 
  'Dangerous' settings (screen res, other crash stuff) removed.
- Different games now store their saves, etc, in their own directory
- Probably more that I have forgotten.


Release notes alephone-dingoo-v1 20101023:
------------------------------------------
- New box scaler. Menu and HUD are looking much nicer now, terminals are (barely) readable. It is barely 25% slower.
- Used tips of the other Dingoo devs to thin out the binary. Build is now fully optimized as well.
- Removed some leftover GP2X code.
- Cleaned up some more unnecessary data files.

Release notes alephone-dingoo-v0 20101016:
------------------------------------------
- Based on Pickle's hard work, it basically compiled on Dingoo without trouble.
- Source changes: Needed an 'add #include <stdexcept>' in 'network_metaserver.h'
  and forced -march=mips32 to keep LUA happy. Also needs libboost in Dingux toolchain. -O3 flags
  halve the binary size and *triple* speed. Sometimes things work like they do in the movies...
- Commented out Pickle's Wiz key mapping (not needed on Dingoo, gp2x.h, screen.cpp and others).
  Found and changed menu keymapping from PC to Dingoo to eliminate the need for a mouse 
  driver/workaround (shell.cpp).
- New menu dialog theme that's better readable (prefs, load, quit game, etc) and fits on the
  Dingoo's small screen (mostly). Looks like crap, but trust me, the original is worse when
  halved from 640x480 to 320x240. Remember: the whole game is still rendered at 640x480 and then
  scaled to fit the screen on your Dingoo.
- Shiny icons :). Made these 7 years ago @ 128x128. They finally have a use.
- A readme that's bigger than Pickle's while having done only a fraction of the work he did.



Todo:
< Nothing comes to mind... >

You might wonder why I'm still using the 2009 source, and not a more recent version. Recent versions compile and run
fine on the dingoo, but contain only OpenGL improvements. They also introduce a lot of extra work due to
openGL and software rendering being less separated, due to pkg-config being required by the config script, etc.


Nigel